CallCompareProc

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallCompareProc
The CallCompareProc method compares two descriptors.
void CallCompareProc (in ODPart thePart,
                      in ODDescType oper, 
                      in ODOSLToken obj1, 
                      in ODOSLToken obj2, 
                      out ODBoolean result);
thePart
A reference to the part associated with this semantic interface object.
oper
The comparison operator that specifies how to compare the two objects.
obj1
A reference to the first object in the comparison.
obj2
A reference to the second object in the comparison.
result
A Boolean value whose meaning depends on the comparison operator.

DISCUSSION
OpenDoc calls this method during object resolution if an object specifier requires comparisons between a series of objects. Your override of this method is responsible for determining what comparisons make sense among your objects and should also be capable of comparing any two objects regardless of class type. For a list of the standard comparison operators that your method should be able to handle, see the "Resolving and Creating Object Specifier Records" chapter of Inside Macintosh: Interapplication Communication.
You can use the name resolver's IsODToken method to determine whether the obj1 and obj2 parameters are OpenDoc tokens or just simple descriptors.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to compare the specified objects.
This method may throw platform-specific exceptions.

SEE ALSO
The ODDescType type (page 925).
The ODNameResolver::IsODToken method (page 425).
The ODOSLToken class (page 456).